13. Multiple operations

Each of the previously described operations acts upon a single entity or resource only. Frequently we have the need to update an interconnected set of entities so that we maintain the consistency of the structure. This requires an atomic operation which can successfully update all the entities or roll back the operation on failure.

The MultiOpType operation provides such a feature. It is essentially a wrapper around any of the other operations which guarantees the success of the entire set or a roll back. Using the id attribute for requests, each individual response can be located in the result. The MultiOpType request takes the following elements

Table 49 — MultiOpType elements

Field

Type

#

?

Description

operations

Sequence of BaseOperationType

1

Y

Contains one or more operations

The response type is also simple containing a single element containing all the responses.

Table 50 — MultiOpResponseType elements

Field

Type

#

?

Description

responses

Sequence of BaseResponseType

1

Y

Contains zero or more responses